Videos: reportAbuse

बुरे बर्ताव वाला कॉन्टेंट दिखाने वाले वीडियो की शिकायत करना.

कोटे पर असर: इस तरीके को कॉल करने पर, 50 यूनिट का कोटा शुल्क लगता है.

अनुरोध

एचटीटीपी अनुरोध

POST https://www.googleapis.com/youtube/v3/videos/reportAbuse

अनुमति देना

इस अनुरोध के लिए, इनमें से कम से कम एक स्कोप के साथ अनुमति की ज़रूरत है (पुष्टि और अनुमति के बारे में ज़्यादा पढ़ें).

दायरा
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl
https://www.googleapis.com/auth/youtubepartner

पैरामीटर

नीचे दी गई टेबल में उन पैरामीटर की सूची दी गई है जिनका इस्तेमाल इस क्वेरी में किया जा सकता है. यहां दिए गए सभी पैरामीटर, क्वेरी पैरामीटर हैं.

पैरामीटर
ज़रूरी नहीं पैरामीटर
onBehalfOfContentOwner string
इस पैरामीटर का इस्तेमाल सिर्फ़ अनुमति वाले अनुरोध में किया जा सकता है. ध्यान दें: यह पैरामीटर सिर्फ़ YouTube कॉन्टेंट पार्टनर के लिए है.

onBehalfOfContentOwner पैरामीटर से पता चलता है कि अनुरोध के लिए दिए गए क्रेडेंशियल, YouTube के कॉन्टेंट मैनेजमेंट सिस्टम (सीएमएस) के उस उपयोगकर्ता की पहचान करते हैं जो पैरामीटर की वैल्यू में बताए गए कॉन्टेंट के मालिक की ओर से काम कर रहा है. यह पैरामीटर, YouTube कॉन्टेंट पार्टनर के लिए है. इनके पास कई अलग-अलग YouTube चैनलों का मालिकाना हक होता है और वे उन्हें मैनेज करते हैं. इसकी मदद से, कॉन्टेंट के मालिक एक बार पुष्टि करके अपने सभी वीडियो और चैनल के डेटा को ऐक्सेस कर सकते हैं. इसके लिए, उन्हें हर चैनल के लिए पुष्टि करने के क्रेडेंशियल देने की ज़रूरत नहीं होती. उपयोगकर्ता जिस सीएमएस खाते से पुष्टि करता है वह YouTube कॉन्टेंट के मालिक से लिंक होना चाहिए.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में डेटा का यह स्ट्रक्चर होता है:

{
  "videoId": string,
  "reasonId": string,
  "secondaryReasonId": string,
  "comments": string,
  "language": string
}

ज़रूरी प्रॉपर्टी

आपको इन प्रॉपर्टी के लिए वैल्यू सेट करनी होंगी:

वैकल्पिक प्रॉपर्टी

इन प्रॉपर्टी के लिए वैल्यू सेट की जा सकती हैं:

प्रॉपर्टी

इस टेबल में, इस संसाधन में दिखने वाली प्रॉपर्टी के बारे में बताया गया है:

प्रॉपर्टी
videoId string
इस एट्रिब्यूट की मदद से, उस वीडियो की पहचान की जाती है जिसकी शिकायत बुरा बर्ताव दिखाने वाले कॉन्टेंट की वजह से की जा रही है. वैल्यू को उस वीडियो के YouTube वीडियो आईडी पर सेट करें.
reasonId object
इस एट्रिब्यूट की मदद से, यह बताया जाता है कि जिस वीडियो की शिकायत की जा रही है उसमें बुरा बर्ताव दिखाने वाला कॉन्टेंट क्यों है. वैल्यू को सही videoAbuseReportReason रिसॉर्स के unique ID पर सेट करें.
secondaryReasonId object
इस एट्रिब्यूट की मदद से, वीडियो में मौजूद बुरे बर्ताव के बारे में दूसरी वजह बताई जाती है. दूसरी वजह, आपत्तिजनक कॉन्टेंट के बारे में मुख्य वजह की तुलना में ज़्यादा जानकारी देती है. reasonId प्रॉपर्टी, मुख्य वजह की पहचान करती है. वैल्यू को, सेकंडरी वजह के unique ID पर सेट करें.
comments string
रिपोर्टर जो भी अतिरिक्त जानकारी जोड़ना चाहता है वह यहां दी जाती है.
language object
रिपोर्टर की बोली जाने वाली भाषा की पहचान करता है.

जवाब

अगर यह तरीका काम करता है, तो यह एचटीटीपी 204 रिस्पॉन्स कोड (No Content) दिखाता है.

गड़बड़ियां

नीचे दी गई टेबल में, गड़बड़ी के ऐसे मैसेज की जानकारी दी गई है जो इस तरीके के कॉल के जवाब में एपीआई दिखा सकता है. ज़्यादा जानकारी के लिए, कृपया गड़बड़ी का मैसेज दस्तावेज़ देखें.

गड़बड़ी का टाइप गड़बड़ी की जानकारी ब्यौरा
badRequest (400) invalidAbuseReason अनुरोध में reasonId प्रॉपर्टी के लिए कोई ऐसी वैल्यू थी जो उम्मीद के मुताबिक नहीं थी या reasonId और secondaryReasonId प्रॉपर्टी का अमान्य कॉम्बिनेशन था.
badRequest (400) rateLimitExceeded उपयोगकर्ता ने तय समयावधि में बहुत ज़्यादा अनुरोध भेजे हैं.
forbidden (403) forbidden
notFound (404) videoNotFound जिस वीडियो के गलत इस्तेमाल की शिकायत की जा रही है वह नहीं मिला.

इसे आज़माएं!

इस एपीआई को कॉल करने और एपीआई का अनुरोध और रिस्पॉन्स देखने के लिए, APIs Explorer का इस्तेमाल करें.